home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / libraries / newiff.lha / NewIFF / NewIFF39.lha / newiff39 / other / Display.doc < prev    next >
Text File  |  1993-09-28  |  8KB  |  261 lines
  1.  
  2. Display 39.11 (c) Copyright 1990-1993 Commodore-Amiga, Inc.
  3.  
  4.  
  5. Display is a program for displaying IFF ILBM format image files.
  6. V39.x Display supports V39 and 8-bit-per-gun AA graphic modes, but still
  7. runs under 1.3 and 2.0 as long as iffparse.library is present.
  8. (2.04 Workbench's iffparse.library will run under 1.3.)
  9.  
  10. The Display program can display single pictures, or can present a keyboard,
  11. mouse, or automatically advanced slide show.  Display can also be used
  12. to print ILBM graphics.
  13.  
  14. Under 2.0 and higher, Display supports overscan screens centered based
  15. on the user's Preferences, autoscroll screens, and explicit modeid for
  16. display if desired.
  17.  
  18.  
  19. Usage Summary
  20. =============
  21. CLI Usage:
  22. Display [from filelist] OR file [file file...] [opt [mlbpaenvf][t=n][d=x]]
  23. opts: <m>ouse (1 pic: mm) <l>oop <b>ack <p>rint <a>utoscroll <e>hb <v>ideo
  24.  <n>otransb <f>it (V39 bestfit) <s>nomonitor <r>nocenter t=seconds d=modeid
  25.  
  26. WB Usage: Via Default Tool, Extend Select, or text FileList Project
  27. ToolTypes:  If FileList: FILELIST=TRUE (Required)
  28. Tool/Filelist: TIMER=n,MODEID=x,Bool MOUSE,MMOUSE,LOOP,PRINT,BACK,BESTFIT,
  29.         NOMONITOR,NOCENTER
  30. Pics: MODEID=x, Boolean EHB,AUTOSCROLL,NOTRANSB,VIDEO,BESTFIT,
  31.         NOMONITOR,NOCENTER
  32.  
  33. Click toggles bar, CTRL-P prints screen
  34. Close display in upper left, or CTRL/C.  CTRL/D to break a script
  35.  
  36.  
  37. Displaying a single ILBM file
  38. =============================
  39.  
  40.    From CLI:
  41.  
  42.    Display filename [opt [mlbpaenvf][t=n][d=x]] (options explained later)
  43.  
  44.    From Workbench:
  45.  
  46.     either    Use the left mouse button to click on (select) the Display
  47.         icon, then shift/double-click the ILBM picture file icon.
  48.  
  49.         or  single click the ILBM picture file icon then select the 
  50.         Workbench Icon menu "Information" item.  Enter Display as the
  51.         Default Tool in the Information requester and Save.
  52.         Now double-clicking that ILBM picture icon will automatically
  53.         load the Display program and display the picture.
  54.  
  55.    Closing the display:
  56.  
  57.       By default, clicking in the upper left corner or using CTRL-C
  58.       will close the display.  Other options described later allow mouse
  59.       advance, looping, and automatically timed displays.
  60.  
  61.  
  62.  
  63.  
  64. Displaying multiple ILBM picture files as a "slide show"
  65. ========================================================
  66.  
  67.    Display has the ability to do a slide show.  There are several methods
  68.    for doing a slide show.  Some are more useful for on-the-fly situations,
  69.    and others are more suitable for planned presentations.
  70.  
  71.  
  72.    From CLI: (options explained later)
  73.  
  74.     either    Display filename filename [filename [filename...]] [opt options]
  75.  
  76.     or    Display from filelist [opt options]
  77.         where filelist is a file which contains an ASCII text list
  78.         of the ILBM filenames you want to display.  A filelist file
  79.         can be created with any plain ASCII text editor such as
  80.         Ed or Memacs.  The contents of an example filelist follows
  81.         (assuming you have a directory called Pictures containing
  82.         some ILBM graphic files):
  83.  
  84.             Work:Pictures/MonaLisa
  85.             Work:Pictures/Max
  86.             Work:Pictures/NewYork
  87.  
  88.         Certain per-picture options may also be specified on each
  89.         line of a filelist (see Options section later).
  90.  
  91.    From Workbench:
  92.  
  93.     either    Single-click on Display, then shift-click the pictures you
  94.         wish to display, shift-double-clicking on the last picture.
  95.  
  96.     or    Set up a slideshow file as follows:
  97.         Create a text filelist as described above and place
  98.         the file in a directory accessible from Workbench.
  99.         Create a "Project" type icon for the file and save the Project
  100.         icon in the same directory as your filelist file, giving
  101.         it the same name as your filelist but with ".info" added
  102.         to the name.  Then select your Project icon (you may have
  103.         to Update the window first) then select Information from
  104.         the Workbench Icon menu.  Enter Display as the Default Tool,
  105.         and add the following tooltype:  FILELIST=TRUE
  106.         Also read about the additional Tooltype options below.
  107.         You may wish to add some like MOUSE=TRUE (for a mouse-advanced
  108.         show) or LOOP=TRUE and TIMER=seconds for an automatic show.
  109.  
  110.  
  111.    Advancing the display:
  112.  
  113.    By default, you must click in the upper left corner or CTRL-C to
  114.    advance from one displayed picture to the next.  However, with simple
  115.    options suchas MOUSE (m), LOOP (l), and TIMER (t), described in #3 below,
  116.    you can advance and back up using the mouse, and create automatic looping
  117.    timed displays.  CTRL-D will terminate an entire slide show and exit
  118.    Display. 
  119.  
  120.  
  121.  
  122. Options
  123. =======
  124.  
  125.    From CLI, Display options are specified after the filename(s) by using
  126.    the "opt" keyword followed by your options.
  127.  
  128.    Example: Display mypicture opt m
  129.  
  130.    In addition, certain options may be specified on a per-picture basis in
  131.    a text filelist for Display.
  132.  
  133.    From Workbench, options are specified as ToolTypes in the icons of the
  134.    Display program, or the ILBM file icons, or in the icon of a filelist.
  135.    ToolTypes are entered using the "Information" selection in Workbench's
  136.    "Icon" menu.  (Single click an icon, then select the Workbench menu item).
  137.    
  138.  
  139.    CLI            Workbench            Description
  140.    ===            =========            ===========
  141.  
  142.    FROM filelist    FILELIST=TRUE        Display the pictures LISTED
  143.                         in the text filelist file
  144.                         attached to this icon
  145.                         (one picture and optional
  146.                         options listed per line)
  147.  
  148.    m            MOUSE=TRUE        Left mouse button advances
  149.                         slideshow, right goes backwards
  150.  
  151.    mm            MMOUSE=TRUE        Left mouse button advances
  152.                         slideshow, even if one one
  153.                         picture is being shown
  154.                         (i.e. click on picture and
  155.                         it goes away)
  156.  
  157.    l            LOOP=TRUE        Rather than exiting after the
  158.                         last picture, loop back to
  159.                         the first picture.
  160.  
  161.    b            BACK=TRUE        Causes pictures to remain as
  162.                         the back screen, unactivated.
  163.                         Useful when printing pictures
  164.                         while working.
  165.  
  166.    a            AUTOSCROLL=TRUE        If picture is bigger than
  167.                         visible display clip, enable
  168.                         autoscrolling - i.e. automatic
  169.                         scrolling when mouse reaches
  170.                         edge of visible display
  171.  
  172.    p            PRINT=TRUE        Cause Display to automatically
  173.                         print each picture that is
  174.                         displayed.  Note that you can
  175.                         also print manually by pressing
  176.                         CTRL-P.
  177.  
  178.    e            EHB=TRUE        Treat unspecified (no CAMG)
  179.                         6-bitplane pictures as Extra
  180.                         Halfbrite rather than HAM.
  181.  
  182.    n            NOTRANSB=TRUE        A 2.0 and ECS option.  Causes
  183.                         borders to NOT be transparent
  184.                         when genlocked.
  185.  
  186.    v            VIDEO=TRUE        A 2.0 and ECS option.  Causes
  187.                         picture to be displayed with
  188.                         full-video display clip.
  189.  
  190.    f            BESTFIT=TRUE        Ignore CAMG modeid if any
  191.                         and instead let OS decide
  192.                         best modeid to display in.
  193.  
  194.    s            NOMONITOR        Crudely strips monitor ID
  195.                         if any from CAMG
  196.  
  197.    r            NOCENTER        If picture is larger than Max
  198.                         Overscan for mode, will place
  199.                         upper left corner of screen
  200.                         at upper left corner of display
  201.                         clip (rather than centering
  202.                         screen around display clip.
  203.                         
  204.    d=hhhhhhhh        DISPLAYMODE=hhhhhhhh    Ignore CAMG mode id if any
  205.                         and instead display using
  206.                         this mode id (where hhhhhhhh
  207.                         is hex mode id with no 0x or $)
  208.  
  209.    t=seconds        TIMER=seconds        For automatic advance when
  210.                         time elapses.
  211.  
  212.  
  213.    The following options may be specified on a per-picture basis in
  214.    a picture icon or in a line of a filelist:
  215.  
  216.    CLI opt    Tooltype
  217.    =======    ========
  218.    e        EHB=TRUE
  219.    n        NOTRANSB=TRUE
  220.    v        VIDEO=TRUE
  221.    a        AUTOSCROLL=TRUE
  222.    f        BESTFIT=TRUE
  223.    s        NOMONITOR=TRUE
  224.    r        NOCENTER=TRUE
  225.    d=hhhhhhhh    DISPLAYMODE=hhhhhhhh
  226.  
  227.    Most other options are global and may only be specified on a CLI
  228.    command line, or in the Display icon, or in a filelist Project icon.
  229.  
  230.  
  231.    
  232. Examples
  233. ========
  234.  
  235.    - Print three files as a background task:
  236.  
  237.      run Display file1 file2 file3 opt bp t=1
  238.  
  239.  
  240.    - Display a list of files as a looping (l) slide show, showing each picture
  241.      for 5 seconds:
  242.  
  243.      Display from myshow opt l t=5   
  244.  
  245.         where the text file "myshow" contains:
  246.  
  247.     path/mypicture1
  248.     path/mypicture2  opt a d=00008004  (extra options for this picture)
  249.     path/mypicture3
  250.  
  251.    - Start a mouse-advance slideshow for a presentation
  252.  
  253.      Display from myshow opt ml
  254.  
  255.  
  256.      Note - if you put a project icon on the file "myshow", set its
  257.      Default Tool to Display, and enter the tooltypes MOUSE=TRUE and
  258.      LOOP=TRUE, you could start the same slide show by double-clicking
  259.      the Project icon.
  260.  
  261.